package com.ruoyi.lock.mapper;

import java.util.List;
import com.ruoyi.lock.domain.AHomeUser;
import org.apache.ibatis.annotations.Param;

/**
 * 入住信息Mapper接口
 * 
 * @author ruoyi
 * @date 2025-07-24
 */
public interface AHomeUserMapper 
{
    /**
     * 查询入住信息
     * 
     * @param id 入住信息主键
     * @return 入住信息
     */
    public AHomeUser selectAHomeUserById(Long id);

    /**
     * 查询入住信息列表
     * 
     * @param aHomeUser 入住信息
     * @return 入住信息集合
     */
    public List<AHomeUser> selectAHomeUserList(AHomeUser aHomeUser);

    public AHomeUser selectAHomeUserList2(AHomeUser aHomeUser);

    /**
     * 新增入住信息
     * 
     * @param aHomeUser 入住信息
     * @return 结果
     */
    public int insertAHomeUser(AHomeUser aHomeUser);

    /**
     * 修改入住信息
     * 
     * @param aHomeUser 入住信息
     * @return 结果
     */
    public int updateAHomeUser(AHomeUser aHomeUser);

    /**
     * 删除入住信息
     * 
     * @param id 入住信息主键
     * @return 结果
     */
    public int deleteAHomeUserById(Long id);

    /**
     * 批量删除入住信息
     * 
     * @param ids 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteAHomeUserByIds(Long[] ids);

    int batchInsertAHomeUser(List<AHomeUser> homeUserList);

    /**
     * 根据homeId和userId更新keyGroupId
     * @param homeId 房间ID
     * @param userId 用户ID
     * @param keyGroupId 钥匙组ID
     * @return 影响行数
     */
    int updateKeyGroupIdByHomeIdAndUserId(@Param("homeId") Long homeId, @Param("userId") Long userId, @Param("keyGroupId") String keyGroupId);
    int updateKeyGroupIdByHomeIdAndUserIdTuiFang(@Param("homeId") Long homeId, @Param("userId") Long userId);

    /**
     * 根据keyGroupId将keyGroupId字段置空
     * @param keyGroupId 钥匙组ID
     * @return 影响行数
     */
    int clearKeyGroupIdByKeyGroupId(@Param("keyGroupId") String keyGroupId);

    /**
     * 根据用户ID查询已入住的房间信息
     * @param userId 用户ID
     * @return 入住信息列表
     */
    List<AHomeUser> selectActiveHomeUserByUserId(@Param("userId") Long userId);

    /**
     * 根据房间ID查询已入住的用户信息
     * @param homeId 房间ID
     * @return 入住信息列表
     */
    List<AHomeUser> selectActiveHomeUserByHomeId(@Param("homeId") Long homeId);

    /**
     * 根据用户ID和房间ID查询入住信息
     * @param userId 用户ID
     * @param homeId 房间ID
     * @return 入住信息
     */
    AHomeUser selectHomeUserByUserIdAndHomeId(@Param("userId") Long userId, @Param("homeId") Long homeId);

    /**
     * 软删除入住信息（将isFlag设置为0）
     * @param id 入住信息ID
     * @return 影响行数
     */
    int softDeleteAHomeUserById(@Param("id") Long id);

    /**
     * 根据用户ID和房间ID软删除入住信息
     * @param userId 用户ID
     * @param homeId 房间ID
     * @return 影响行数
     */
    int softDeleteByUserIdAndHomeId(@Param("userId") Long userId, @Param("homeId") Long homeId);

    /**
     * 根据用户ID和房间ID清空key_group_id
     * @param userId 用户ID
     * @param homeId 房间ID
     * @return 影响行数
     */
    int clearKeyGroupIdByUserIdAndHomeId(@Param("userId") Long userId, @Param("homeId") Long homeId);
}
